gh-84116: Docs: Document help and aliases for argparse.add_parser() #140574
Conversation
…python into doc-fix-140281
Krishna-web-hub
force-pushed
the
doc-fix-84116
branch
from
57a35b9 to
343648b
Compare
StanFromIreland
changed the title
StanFromIreland
left a comment
StanFromIreland
left a comment
There was a problem hiding this comment.
There seem to be two different things mixed in this PR, please split it.
Krishna-web-hub
force-pushed
the
doc-fix-84116
branch
from
ce36e2d to
10dffc6
Compare
|
Before continuing working on this PR, please fix the conflicts. |
|
Hi @picnixz , |
|
If some changes were mentioned in another PR, please merge main into this branch. You need to do it because there are conflicts. And those conflicts must be resolved before merging: 
Once the diff is clean maybe some changes will be correct. But we are still lacking some description that are now gone and that must not be changed. |
|
Hi @picnixz , @savannahostrowski I have done the requested change please review it again. |
|
@picnixz , @savannahostrowski i want to know what i will be doing for the |
|
Keep your changes for that. |
Doc/library/argparse.rst
Outdated
| .. method:: _SubParsersAction.add_parser(name, *, help=None, aliases=None, | ||
| deprecated=False, **kwargs) |
There was a problem hiding this comment.
You need to aligned deprecated with name.
Hello @picnixz ,
do you want it like this or something else. Please confirm me so that i can work in that direction.
|
Krishna-web-hub
force-pushed
the
doc-fix-84116
branch
from
1f5da7c to
05213dd
Compare
|
Please @picnixz , give me final instruction to fix this documentation issue |
5 participants
gh-84116: Doc: update the argparse documentation to clearly define the help and aliases parameters for add_parser() and added the required news file for this change.
Doc/library/argparse.rst
Replaced the vague, single-sentence description of _SubParsersAction.add_parser with a formal .. method:: directive.
This new directive explicitly lists help and aliases as parameters, along with descriptions of what they do.
Removed the old, redundant paragraphs about help (which was in parentheses) and aliases (which was a "Furthermore..." note) from later in the document. This centralizes all the information in one logical place.
Misc/NEWS.d/next/Library/...
Added the required "blurb" file to log this documentation fix.
📚 Documentation preview 📚: https://cpython-previews--140574.org.readthedocs.build/